home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / mopt118 / msyst.doc < prev    next >
Text File  |  1994-11-30  |  7KB  |  157 lines
  1.                                 MSYST
  2.                         A User Terminal Program
  3.                      For use with TNC's or Modems
  4.                               By WA8BXN
  5.  
  6.                  (C) Copyright 1994 Hub Computers, Inc.
  7.  
  8.  
  9. This program and documentation is shareware. If you find it useful please
  10. send $5 (or more!) to support further development of this program and the
  11. MSYS BBS system. Distribution of this program will be through electronic
  12. means (the Cleveland Hamnet telephone BBS, for example). You may also 
  13. provide copies of the program and this documentation file to other 
  14. amateur radio operators interested in using it provided no changes are
  15. made to this documentation file nor the program. Make out your check to and
  16. send to:
  17. Michael Pechura
  18. 10809 Beechwood Drive
  19. Kirtland, OH 44094
  20.  
  21. Introduction
  22. ------------
  23.  
  24. This program was written primarily to allow use of the YAPP protocol
  25. provided by MSYS for file (binary or ASCII) uploading and downloading
  26. using either modem or tnc. It includes additional functions that make
  27. it usable as a simple terminal program for general use. It can be used
  28. with most TNC's that can be used with a terminal emulator program as
  29. well as most modems. Basic features include
  30.         * YAPP protocol support
  31.         * ASCII file capture
  32.         * ASCII file transmission
  33.         * 800 line scroll back buffer
  34.         * DOS Shell to run other programs without exiting MSYST
  35.         * Interrupt driven serial I/O with 16,000 byte input buffer
  36.         * Support for serial ports at any address and Int 0-7
  37.     * Reverse forward poll for messages
  38.      * Forward to a bbs
  39.  
  40. Installation
  41. ------------
  42.  
  43. MSYST automatically will create a configuration file the first time you
  44. run it. It will ask you questions whose answers will be stored in the
  45. file MSYST.DEF. If you ever want to change any of your selections, all
  46. you have to do is delete MSYST.DEF and run MSYST to go through the
  47. configuration procedure again. The following options are configurable:
  48.         * Serial port address
  49.         * Interrupt number
  50.         * Serial port speed
  51.         * Text background color
  52.         * Text foreground color
  53.         * CTS support (Turn it on unless it causes program to hang)
  54.  
  55. Usage
  56. -----
  57.  
  58. For the most part what ever you type at the keyboard is sent to your 
  59. modem or TNC. The exceptions to this are the following keys:
  60.         F1  - Gives brief help information
  61.         F2  - Receive YAPP file after you tell BBS to send the file
  62.         F3  - Send YAPP file after you tell BBS to receive the file
  63.         F4  - Capture what appears on screen to a file
  64.         F5  - Send an ASCII file as if typed
  65.         F6  - End capture
  66.     F7  - Forward from file
  67.         F8  - Send password reply using PASSWORD.RMT file
  68.         F9  - DOS Shell (use exit command to return to MSYST)
  69.     F10 - Poll for messages
  70.      Alt/X  - Exit MSYST
  71.  
  72.         Arrow keys, Page Up or Down, Home, and End enter scroll back mode.
  73. To exit this mode, press Escape. F1 key (only F key that works when in
  74. scroll back mode) will give help summary. Alt/X will exit scroll mode and
  75. the program as well. While in scroll back mode incoming data is not 
  76. displayed but is accumulated in the 16,000 byte input buffer. When you
  77. exit scroll back mode it will be displayed. 
  78.  
  79. F7 (forward from file): Prepare a file that contains what you would
  80. normally type when sending messages manually to a bbs. That would be
  81. a S command line, then the title on another line, and the the lines
  82. that contain the text. End the message with /EX. Here is an example:
  83. S NO8M@NO8M
  84. Hello Steve
  85. Hi Steve - Let me know if you get this message. I am going to upload it
  86. to the bbs using the MSYST F7 function. 73 - Mike
  87. /EX
  88. Note: the file can contain multiple messages.
  89.  
  90. After you have created and saved the file, connect to your local bbs. 
  91. When you get the command prompt from the bbs, press F7. You will be 
  92. asked for the name of the file to forward. Give the name of the file
  93. you created and then sit back and watch the messages be forwarded.
  94.  
  95.  
  96. F10 (poll for messages): This function will poll a bbs for messages and
  97. collect them all in a single file that you can later examine (perhaps
  98. after you disconnect). Connect to your local bbs and then press F10.
  99. You will be asked for a file name to save what you are sent (POLL.DAT
  100. is the default). When you are done getting your messages you will be
  101. disconnected by the bbs. NOTE: The bbs you connect to must be set up
  102. to reverse forward messages to you. 
  103.  
  104.  
  105. Using YAPP Protocol to transfer files
  106. -------------------------------------
  107.  
  108. Using YAPP is particularly easy when you are using a modem connection to 
  109. MSYS. To download a file, type YD and the filename you want MSYS to send.
  110. Then press F2 and give the name you want the file to have on your system.
  111. You must complete this within 30 seconds of sending the YD command to MSYS.
  112. Next sit back and watch the file status be updated as the file is received.
  113.  
  114. To upload a file using a modem, type YU and the name the file will have
  115. on the MSYS system. When MSYS says its ok to send your file (note that
  116. you have to be specifically enabled to upload files) press F3. Give the
  117. name of the file you want to send and wait for it to be sent.
  118.  
  119. Using a TNC complicates things a bit because you have to switch your TNC
  120. into transparent mode for the actual data transfer. To receive a file,
  121. do the following:
  122.         Type YD followed by the name of the file on MSYS you want
  123.         When MSYS says to get ready to receive the file, type ^C to
  124.                 get back into your TNC's command mode
  125.         Type the command for your tnc to get it into transparent mode 
  126.                 (Usually TRANS)
  127.         Press F2 and give the name you want the file to have on your system
  128.         When the file transfer is complete, excape transparent mode
  129.                 (usually by typing ^C^C^C) to get back to your
  130.                 TNC's command mode.
  131.         Now type the command to get your TNC in normal conversation
  132.                 mode (usually CONV or K)
  133.  
  134. To send a file using a TNC, do the following:
  135.         Type YU and the name the file is to have on the MSYS system
  136.         When MSYS says its ok to send the file, type ^C to get to 
  137.                 the TNC command mode.
  138.         Get the TNC into transparent mode (see above)
  139.         Press F3 and enter the name of the file on your system
  140.         When the file transfer is complete, follow the instructions above
  141.  
  142.  
  143. If there is enough interest and support for this program it will be 
  144. improved in the future. Possible enhancements could include VGA support,
  145. compressed data transmission and "smart" interaction with MSYS. And of 
  146. course an improved documentation file. At this time I mainly want to
  147. provide a way to use the YAPP additions to MSYS over the phone (most
  148. of the other YAPP programs automate getting a TNC into transparent mode
  149. and thus can't easily be used with modems) and to test the waters to
  150. see what interest and support there may be for this program. Enjoy!
  151.  
  152. Note: As of release 1.18 there has been little interest expressed in
  153. this program. So don't expect a lot of work to go into improvements!
  154. I may be adding things from time to time that I find I need (I use the
  155. program myself when out camping).
  156.  
  157.